home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / nwlite / faxdoc.exe / 2806.TXT < prev    next >
Text File  |  1993-06-18  |  15KB  |  398 lines

  1.  
  2.  
  3.                              FYI
  4.  
  5. (Note: The origin of this information may be internal or external
  6. to Novell.  Novell makes every effort within its means to verify
  7. this information.  However, the information provided in this
  8. document is FOR YOUR INFORMATION only.  Novell makes no explicit
  9. or implied claims to the validity of this information.)
  10.  
  11.           TITLE:    NET.CFG Parameters and Their Use with NetWare
  12.                     Lite
  13.    DOCUMENT ID#:    FYI.P.6141
  14.            DATE:    15JUN93
  15.         PRODUCT:    NetWare Lite
  16. PRODUCT VERSION:    v1.1
  17.      SUPERSEDES:    NA
  18.  LITE FAX DOC #:    2806
  19.  
  20. SYMPTOM
  21.  
  22.      NA
  23.  
  24. ISSUE/PROBLEM
  25.  
  26.      The information contained in this document is taken from the
  27.      NOVELL NetWare ODI Shell for DOS and the NetWare Version
  28.      3.11 Installation manuals.  It is intended to help when
  29.      creating and changing the NET.CFG when used with ODI drivers
  30.      and NetWare Lite.
  31.  
  32.      The NET.CFG is a control file that contains information and
  33.      options used to change the default parameters of the ODI
  34.      driver.
  35.  
  36.      If you are using IPXODI and have not changed the default
  37.      settings on the LAN adapter, then you do not need a NET.CFG
  38.      file.
  39.  
  40.      If you are using Novell's LAN Workplace or a third-party
  41.      protocol (such as TCP/IP) or if you have changed any of the
  42.      hardware options, you need a NET.CFG file.
  43.  
  44.      Create the NET.CFG file using a DOS editor.
  45.  
  46.      Make the main section headings left-justified.  Indent the
  47.      options with a space or a tab under each heading.  The
  48.      options and main headings are not case sensitive.
  49.  
  50.      Create the following as the main section headings for the
  51.      NET.CFG:
  52.  
  53.      1.   Link Support
  54.      2.   Protocol <protocol_name>
  55.      3.   Link Driver <drivername>
  56.  
  57.      Comments can be entered in the file by preceding the line
  58.      with a semicolon (;).  End each line with a hard carriage
  59.      return.
  60.      All numbers used in the file are to be entered in decimal
  61.      form unless otherwise noted.
  62.  
  63.  
  64.  
  65.      The following is a list of valid options for each main
  66.      heading:
  67.  
  68.      Link Support
  69.  
  70.           BUFFERS communication_number [size]
  71.                This option configures the number and size of the
  72.                receive buffers.  The number of buffers must be
  73.                large enough to hold all packet headers and the
  74.                maximum data size.  Minimum size of the buffers is
  75.                618, and the default is 1130.  The default number
  76.                of buffers is 0.
  77.  
  78.                Note:  The IPXODI protocol stack does not use the
  79.                Link Support Layer buffers.  Novell's TCP/IP
  80.                requires at least two buffers.
  81.  
  82.                Example:       Link Support
  83.                                    Buffers 2 1130
  84.  
  85.           MEMPOOL number [k]
  86.                Some protocols use this option to configure the
  87.                size of the memory pool buffers that the LSL will
  88.                maintain.  Refer to your third-party documentation
  89.                for the settings needed.  Novell's TCP/IP requires
  90.                at least 2048 bytes of MEMPOOL.  The [k] means
  91.                that you need to specify the number in multiples
  92.                of 1024.
  93.  
  94.                Note:  The IPXODI protocol stack does not use the
  95.                MEMPOOL buffers.
  96.  
  97.                Example:       Link Support
  98.                                    MEMPOOL 2048
  99.  
  100.      Protocol protocol_name
  101.  
  102.           BIND name
  103.                Usually IPXODI binds to the first network board it
  104.                finds. This option limits the search to the
  105.                network board you specify.  Replace NAME with the
  106.                LAN driver name.
  107.  
  108.                Example:       Protocol IPX
  109.                                    Bind NE2000
  110.  
  111.           SESSIONS number
  112.                This option configures the number of sessions the
  113.                protocol stack will be required to maintain at one
  114.                time.  See your third-party documentation to see
  115.                if this parameter is applicable to you.
  116.  
  117.                Note:  IPXODI ignores this parameter.
  118.  
  119.                Example:       Protocol IPX
  120.                                    SESSIONS 5
  121.  
  122.  
  123.  
  124.      Link Driver drivername
  125.  
  126.           DMA  [#1|#2] channel_number
  127.                This option specifies the hardware DMA setting of
  128.                the network board used in the workstation.  Enter
  129.                the channel number to be used.  If the default
  130.                channel is not specified, it is #1.
  131.  
  132.                Example:       Link Driver NE2000
  133.                                    DMA 3
  134.  
  135.           INT  [#1|#2] interrupt_request_number
  136.                This option specifies the interrupt for the
  137.                network board used.  If you do not specify which
  138.                interrupt line (#1 or #2) to configure, this
  139.                option uses #1 as the default interrupt line.
  140.  
  141.                Example:       Link Driver NE2000
  142.                                    INT 2
  143.  
  144.           MEM  [#1|#2] hex_starting_address [hex_length]
  145.                This option specifies a memory range for the
  146.                network board.  Enter the hex physical address of
  147.                the memory used by the board.  The starting
  148.                address must match the starting address configured
  149.                on the board.  Enter the length of the memory
  150.                address used by the board, which is usually 16
  151.                bytes.
  152.  
  153.                Example:       Link Driver TRXNET
  154.                                    MEM D0000
  155.  
  156.                Note:  Usually the length is not needed.
  157.  
  158.           PORT [#1|#2] hex_starting_address hex_number_of_ports
  159.                Use this option to specify the starting port and
  160.                number of ports in the range.  Enter all values in
  161.                their hex form.
  162.  
  163.                Example:       Link Driver NE2000
  164.                                    PORT 300
  165.  
  166.                Note:  The number of ports is optional.
  167.  
  168.           NODE ADDRESS hex_address
  169.                If the hardware allows it, this option overrides
  170.                the hard-coded node address for the network board. 
  171.                Enter the number in hex form.
  172.  
  173.                Example:       Link Driver NE2000
  174.                                    Node Address 1BAD1234
  175.  
  176.                Note:  Changing the node address can create
  177.                conflicts with other network boards.  Novell
  178.                suggests that you stay with the hard-coded node
  179.                address whenever possible.
  180.  
  181.  
  182.  
  183.           SLOT number
  184.                Use the number of the slot into which you inserted
  185.                the board.  The slot number is found on the back
  186.                of the computer.  The driver will then use the
  187.                board found in that slot.
  188.  
  189.                Example:  If you are using two NE/2 boards in the
  190.                          same workstation and you insert one
  191.                          board into slot 1 and one into slot 2,
  192.                          the NET.CFG will look like the
  193.                          following:
  194.  
  195.                               Link Driver NE2
  196.  
  197.                               Link Driver NE2
  198.                                    Slot 2
  199.  
  200.                          Then place the following lines in your
  201.                          AUTOEXEC.BAT file:
  202.                               LSL
  203.                               NE2
  204.                               NE2
  205.  
  206.           FRAME frame_type
  207.                This option specifies the frame type used with the
  208.                network board.  Use this option to support
  209.                multiple frame types.
  210.  
  211.                Example:       Link Driver
  212.                                    Frame ETHERNET_II
  213.                                    Frame ETHERNET_802.3
  214.  
  215.           PROTOCOL name hex_protocol_ID frame_type
  216.                This option allows new protocols to be handled by
  217.                existing drivers.  Replace NAME with the name of
  218.                the new protocol.  Use the assigned hex ID number. 
  219.                Replace FRAME_TYPE with the frame type for the new
  220.                protocol.
  221.  
  222.                Example:  If you are using a new protocol (XYZ)
  223.                          with an NE2-32 network board, the
  224.                          NET.CFG file would look similar to the
  225.                          following:
  226.  
  227.                     Link Driver NE2-32
  228.                          Frame ETHERNET_SNAP
  229.                          Protocol XYZ 904A ETHERNET_SNAP
  230.  
  231.           SAPS number
  232.                If you use the LANSUP driver, you may specify the
  233.                number of Service Access Points (SAPs) needed. 
  234.                Set this option to allow for all applications
  235.                using the IBM LAN Support Program.  The maximum
  236.                value depends on the type of board used.  The
  237.                default is 1.
  238.  
  239.           LINK STATIONS number
  240.                If you use the LANSUP driver, you may specify the
  241.                number of link stations needed.  Set the option to
  242.                allow for all applications using the IBM LAN
  243.  
  244.  
  245.                Support Program.  The maximum depends on the type
  246.                of network board used.  The Default is 1.
  247.  
  248.           ALTERNATE
  249.                Normally the LANSUP, Token, and PCN2 drivers will
  250.                use a primary adapter.  Use this option so the
  251.                driver will use a different adapter.
  252.  
  253.                Example:       Link Driver LANSUP
  254.                                    ALTERNATE
  255.  
  256.           MAX FRAME SIZE number
  257.                This option sets the maximum number of bytes that
  258.                the Token-Ring adapter can put on the wire.  The
  259.                default is 4216.  The value for NUMBER must be a
  260.                multiple of 8.  It must include the number of
  261.                bytes for the data packet, for adapter overhead (6
  262.                bytes), and for the largest possible header
  263.                (currently, 35 bytes LAN header, plus 5 bytes SNAP
  264.                header, plus 74 bytes protocol header equaling 114
  265.                bytes).
  266.  
  267.                Example:  If you wanted to run with 2 KB packets,
  268.                          the number would be calculated as the
  269.                          following:
  270.  
  271.                          2048 + 6 + 35 + 5 + 74 = 2168
  272.  
  273.                     The NET.CFG would look similar to the
  274.                     following:
  275.  
  276.                          Link Driver TOKEN
  277.                               MAX FRAME SIZE 2168
  278.  
  279.      Network Sharing = ON
  280.           This is a previously undocumented and a currently
  281.           unsupported parameter.  However, for more information
  282.           on this parameter, see FAX Document 2807 or FYI.P.6144.
  283.  
  284.      Route=xxxxxxxx:yyyyyyyyyyyy
  285.           This is a previously undocumented and a currently
  286.           unsupported parameter.  However, for more information
  287.           on this parameter, see FAX Document 2807 or FYI.P.6144.
  288.  
  289.      Domain=n
  290.           This is a previously undocumented and a currently
  291.           UNSUPPORTED parameter.  However, for more information
  292.           on this parameter, see FAX Document 2807 or FYI.P.6144.
  293.  
  294.      These are the parameters specific to the NET.CFG.  However,
  295.      many of the parameters for the SHELL.CFG that are used by
  296.      IPX.COM can also be used in the NET.CFG for IPXODI.COM. 
  297.      Some of these are explained in the following paragraphs.
  298.  
  299.      All the following parameters can be added to the NET.CFG
  300.      file.  These parameters should be entered at the top of the
  301.      file (before the Link Support area) and must be
  302.      left-justified.
  303.  
  304.  
  305.  
  306.      INT64=on/off
  307.           This parameter allows applications to use interrupt 64h
  308.           to access IPX services.  Default=ON
  309.  
  310.      INT7A=on/off
  311.           This parameter allows applications to use interrupt 7A
  312.           to access IPX services.  Default=ON
  313.  
  314.      IPX RETRY COUNT=n
  315.           This parameter sets the number of times the workstation
  316.           resends a packet.  On networks that lose many packets,
  317.           this retry count may need to be increased.  Increasing
  318.           this number will cause a longer delay for some network
  319.           functions.  Default=20 retries
  320.  
  321.      IPX SOCKETS=n
  322.           This parameter specifies the maximum number of sockets
  323.           that IPX can have open at the workstation.  An IPX
  324.           specific programs may require more than the default
  325.           number of sockets.  Default=20 sockets
  326.  
  327.      SPX ABORT TIMEOUT=n
  328.           This parameter adjusts the amount of time that SPX will
  329.           wait, without receiving any response from the other
  330.           side of the connection, before it terminates the
  331.           session.  The timeout number is in ticks (18.21 ticks
  332.           per second on IBM PCs and compatibles).  Default=540
  333.           ticks (about 30 seconds)
  334.  
  335.      SPX CONNECTIONS=n
  336.           This parameter specifies the maximum number of SPX
  337.           connections a workstation can use at the same time.  
  338.           Default: 15 connections.
  339.  
  340.      SPX LISTEN TIMEOUT=n
  341.           This parameter adjusts the time that SPX will wait,
  342.           without receiving a packet from the other side of the
  343.           connection, before it starts requesting the other side
  344.           to send back a packet ensuring the connection is still
  345.           valid.  If SPX has not received from the other side of
  346.           the connection within this time, it will send packets
  347.           to the other side prompting for verification that the
  348.           connection still exists.  The timeout number is in
  349.           ticks.  Default=108 ticks (about 6 seconds)
  350.  
  351.      SPX VERIFY TIMEOUT=n
  352.           This parameter adjusts the frequency at which SPX sends
  353.           a packet to the other side of a connection to inform it
  354.           that its side is still alive.  If no packets are being
  355.           exchanged on the SPX connection by the software that
  356.           established the session, SPX will send packets at
  357.           regular intervals to make sure that the connection is
  358.           still working.  The timeout number is in ticks.  
  359.           Default=54 ticks (about 3 seconds)
  360.  
  361.  
  362.  
  363.      The following are some examples of how to put all of this
  364.      together:
  365.  
  366.      Example 1:
  367.  
  368.           route=00beef00:ffffffffffff
  369.           domain=59
  370.           ipx retry count =25
  371.  
  372.           Link Support
  373.              Buffers 8 1500
  374.              MemPool 4096
  375.  
  376.           Protocol IPX
  377.              BIND NE2000
  378.  
  379.           Link Driver NE2000
  380.                INT 3
  381.                PORT 300
  382.                Frame Ethernet_802.3
  383.                Frame Ethernet_II
  384.                Frame Ethernet_SNAP
  385.                Protocol IPX 0 Ethernet_802.3
  386.                Protocol TCPIP 8137 ethernet_II
  387.  
  388.      Example 2:
  389.  
  390.           route=00123456:00001b123456
  391.           domain=10
  392.           ipx retry count=30
  393.           network sharing=on
  394.  
  395.                link driver NE2000
  396.                     int 5
  397.                     port 340
  398.